Clarify GtkH/VBox documentation

Make it clearer that GtkBox still has uses.

https://bugzilla.gnome.org/show_bug.cgi?id=706269

diff --git a/gtk/deprecated/gtkhbox.c b/gtk/deprecated/gtkhbox.c
index a5fe1a87adbf153efa95108ba942b28150c57732..5c6b3cad6d3980ce7573a0e0b3aee7fed1930e3e 100644 (file)
--- a/gtk/deprecated/gtkhbox.c
+++ b/gtk/deprecated/gtkhbox.c
@@ -50,10 +50,10 @@ G_GNUC_BEGIN_IGNORE_DEPRECATIONS
  * from #GtkBox. No further changes are needed, since the default
  * value of the #GtkOrientable:orientation property is
  * %GTK_ORIENTATION_HORIZONTAL.
- * If you want your code to be future-proof, the recommendation is to
- * switch to #GtkGrid, since #GtkBox is going to be deprecated in favor
- * of the more flexible grid widget eventually. For more information
- * about migrating to #GtkGrid, see <xref linkend="gtk-migrating-GtkGrid"/>
+ * If you don't need first-child or last-child styling, and want your code
+ * to be future-proof, the recommendation is to switch to #GtkGrid instead
+ * of nested boxes. For more information about migrating to #GtkGrid,
+ * see <xref linkend="gtk-migrating-GtkGrid"/>
  */
 
 

diff --git a/gtk/deprecated/gtkvbox.c b/gtk/deprecated/gtkvbox.c
index 707ccec4ce7ba173108d8d580129782d792c9464..7745045f9a213db2730202d520dc3873fd2f2103 100644 (file)
--- a/gtk/deprecated/gtkvbox.c
+++ b/gtk/deprecated/gtkvbox.c
@@ -55,10 +55,10 @@ G_GNUC_BEGIN_IGNORE_DEPRECATIONS
  *   gtk_orientable_set_orientation (GTK_ORIENTABLE (object),
  *                                   GTK_ORIENTATION_VERTICAL);
  * ]|
- * If you want your code to be future-proof, the recommendation is to
- * switch to #GtkGrid, since #GtkBox is going to be deprecated in favor
- * of the more flexible grid widget eventually. For more information
- * about migrating to #GtkGrid, see <xref linkend="gtk-migrating-GtkGrid"/>.
+ * If you don't need first-child or last-child styling and want your code
+ * to be future-proof, the recommendation is to switch to #GtkGrid instead
+ * of nested boxes. For more information about migrating to #GtkGrid,
+ * see <xref linkend="gtk-migrating-GtkGrid"/>.
  */
 
 G_DEFINE_TYPE (GtkVBox, gtk_vbox, GTK_TYPE_BOX)